home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XCrossingEvent.z / XCrossingEvent
Encoding:
Text File  |  1998-10-30  |  8.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXCCCCrrrroooossssssssiiiinnnnggggEEEEvvvveeeennnntttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXCCCCrrrroooossssssssiiiinnnnggggEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XCrossingEvent - EnterNotify and LeaveNotify event structure
  10.  
  11.      SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEESSSS
  12.           The structure for _E_n_t_e_r_N_o_t_i_f_y and _L_e_a_v_e_N_o_t_i_f_y events
  13.           contains:
  14.  
  15.           typedef struct {
  16.                int type;                /* EnterNotify or LeaveNotify */
  17.                unsigned long serial;    /* # of last request processed by server */
  18.                Bool send_event;         /* true if this came from a SendEvent request */
  19.                Display *display;        /* Display the event was read from */
  20.                Window window;           /* ``event'' window reported relative to */
  21.                Window root;             /* root window that the event occurred on */
  22.                Window subwindow;        /* child window */
  23.                Time time;               /* milliseconds */
  24.                int x, y;                /* pointer x, y coordinates in event window */
  25.                int x_root, y_root;      /* coordinates relative to root */
  26.                int mode;                /* NotifyNormal, NotifyGrab, NotifyUngrab */
  27.                int detail;
  28.                                         /*
  29.                                         * NotifyAncestor, NotifyVirtual, NotifyInferior,
  30.                                         * NotifyNonlinear,NotifyNonlinearVirtual
  31.                                         */
  32.                Bool same_screen;        /* same screen flag */
  33.                Bool focus;              /* boolean focus */
  34.                unsigned int state;      /* key or button mask */
  35.           } XCrossingEvent;
  36.           typedef XCrossingEvent XEnterWindowEvent;
  37.           typedef XCrossingEvent XLeaveWindowEvent;
  38.  
  39.           When you receive these events, the structure members are set
  40.           as follows.
  41.  
  42.           The type member is set to the event type constant name that
  43.           uniquely identifies it.  For example, when the X server
  44.           reports a _G_r_a_p_h_i_c_s_E_x_p_o_s_e event to a client application, it
  45.           sends an _X_G_r_a_p_h_i_c_s_E_x_p_o_s_e_E_v_e_n_t structure with the type member
  46.           set to _G_r_a_p_h_i_c_s_E_x_p_o_s_e.  The display member is set to a
  47.           pointer to the display the event was read on.  The
  48.           send_event member is set to _T_r_u_e if the event came from a
  49.           _S_e_n_d_E_v_e_n_t protocol request.  The serial member is set from
  50.           the serial number reported in the protocol but expanded from
  51.           the 16-bit least-significant bits to a full 32-bit value.
  52.           The window member is set to the window that is most useful
  53.           to toolkit dispatchers.
  54.  
  55.           The window member is set to the window on which the
  56.           _E_n_t_e_r_N_o_t_i_f_y or _L_e_a_v_e_N_o_t_i_f_y event was generated and is
  57.           referred to as the event window. This is the window used by
  58.           the X server to report the event, and is relative to the
  59.           root window on which the event occurred. The root member is
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXCCCCrrrroooossssssssiiiinnnnggggEEEEvvvveeeennnntttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXCCCCrrrroooossssssssiiiinnnnggggEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           set to the root window of the screen on which the event
  75.           occurred.
  76.  
  77.           For a _L_e_a_v_e_N_o_t_i_f_y event, if a child of the event window
  78.           contains the initial position of the pointer, the subwindow
  79.           component is set to that child.  Otherwise, the X server
  80.           sets the subwindow member to _N_o_n_e.  For an _E_n_t_e_r_N_o_t_i_f_y
  81.           event, if a child of the event window contains the final
  82.           pointer position, the subwindow component is set to that
  83.           child or _N_o_n_e.
  84.  
  85.           The time member is set to the time when the event was
  86.           generated and is expressed in milliseconds.  The x and y
  87.           members are set to the coordinates of the pointer position
  88.           in the event window.  This position is always the pointer's
  89.           final position, not its initial position.  If the event
  90.           window is on the same screen as the root window, x and y are
  91.           the pointer coordinates relative to the event window's
  92.           origin. Otherwise, x and y are set to zero.  The x_root and
  93.           y_root members are set to the pointer's coordinates relative
  94.           to the root window's origin at the time of the event.
  95.  
  96.           The same_screen member is set to indicate whether the event
  97.           window is on the same screen as the root window and can be
  98.           either _T_r_u_e or _F_a_l_s_e.  If _T_r_u_e, the event and root windows
  99.           are on the same screen.  If _F_a_l_s_e, the event and root
  100.           windows are not on the same screen.
  101.  
  102.           The focus member is set to indicate whether the event window
  103.           is the focus window or an inferior of the focus window.  The
  104.           X server can set this member to either _T_r_u_e or _F_a_l_s_e.  If
  105.           _T_r_u_e, the event window is the focus window or an inferior of
  106.           the focus window.  If _F_a_l_s_e, the event window is not the
  107.           focus window or an inferior of the focus window.
  108.  
  109.           The state member is set to indicate the state of the pointer
  110.           buttons and modifier keys just prior to the event.  The X
  111.           server can set this member to the bitwise inclusive OR of
  112.           one or more of the button or modifier key masks:
  113.           _B_u_t_t_o_n_1_M_a_s_k, _B_u_t_t_o_n_2_M_a_s_k, _B_u_t_t_o_n_3_M_a_s_k, _B_u_t_t_o_n_4_M_a_s_k,
  114.           _B_u_t_t_o_n_5_M_a_s_k, _S_h_i_f_t_M_a_s_k, _L_o_c_k_M_a_s_k, _C_o_n_t_r_o_l_M_a_s_k, _M_o_d_1_M_a_s_k,
  115.           _M_o_d_2_M_a_s_k, _M_o_d_3_M_a_s_k, _M_o_d_4_M_a_s_k, _M_o_d_5_M_a_s_k.
  116.  
  117.           The mode member is set to indicate whether the events are
  118.           normal events, pseudo-motion events when a grab activates,
  119.           or pseudo-motion events when a grab deactivates.  The X
  120.           server can set this member to _N_o_t_i_f_y_N_o_r_m_a_l, _N_o_t_i_f_y_G_r_a_b, or
  121.           _N_o_t_i_f_y_U_n_g_r_a_b.
  122.  
  123.           The detail member is set to indicate the notify detail and
  124.           can be _N_o_t_i_f_y_A_n_c_e_s_t_o_r, _N_o_t_i_f_y_V_i_r_t_u_a_l, _N_o_t_i_f_y_I_n_f_e_r_i_o_r,
  125.           _N_o_t_i_f_y_N_o_n_l_i_n_e_a_r, or _N_o_t_i_f_y_N_o_n_l_i_n_e_a_r_V_i_r_t_u_a_l.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXCCCCrrrroooossssssssiiiinnnnggggEEEEvvvveeeennnntttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXCCCCrrrroooossssssssiiiinnnnggggEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.           XAnyEvent(3X11), XButtonEvent(3X11),
  142.           XCreateWindowEvent(3X11), XCirculateEvent(3X11),
  143.           XCirculateRequestEvent(3X11), XColormapEvent(3X11),
  144.           XConfigureEvent(3X11), XConfigureRequestEvent(3X11),
  145.           XDestroyWindowEvent(3X11), XErrorEvent(3X11),
  146.           XExposeEvent(3X11), XFocusChangeEvent(3X11),
  147.           XGraphicsExposeEvent(3X11), XGravityEvent(3X11),
  148.           XKeymapEvent(3X11), XMapEvent(3X11), XMapRequestEvent(3X11),
  149.           XPropertyEvent(3X11), XReparentEvent(3X11),
  150.           XResizeRequestEvent(3X11), XSelectionClearEvent(3X11),
  151.           XSelectionEvent(3X11), XSelectionRequestEvent(3X11),
  152.           XUnmapEvent(3X11), XVisibilityEvent(3X11)
  153.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.